uncontrolled copy when printed or downloaded. please refer to the 4d systems website for the latest revision of this document raspberry pi display module pack featuring a 3.2 display module ulcd - 32 - ptu - pi document date: 23 rd january 2013 document revision: 1.1 d atasheet 4d systems turning technology into art
ulcd - 24 - ptu - pi C raspberry pi display module pack contents 1. description ................................ ................................ ................................ ............................. 3 2. advanced hardware options ................................ ................................ ................................ .. 4 3. c library functions ................................ ................................ ................................ ................. 5 4. specifications and ratings ................................ ................................ ................................ ....... 8 5. legal notice ................................ ................................ ................................ ............................ 9 6. contact information ................................ ................................ ................................ ............... 9
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 3 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack 1. d escription the 4d systems raspberry pi display module pack ( ulcd - 32 - ptu - pi ) is made up of a ulcd - 32 - ptu display module specifically customised for the raspberry pi . the pack comprises of: ? customised ulcd - 32 - ptu display module ? 4d serial pi adaptor ? 5 way female - female cable the raspberry pi display module pack enables a raspberry pi user to quickly connect the 4d serial pi adaptor to their raspberry pi , connect the 5 way cable between the adaptor and the display module, and be connected in seconds to start programming their new 4d systems display. the display m odule can be programmed in a number of ways, using the 4d systems workshop 4 ide software. by default the display module will co me loaded with the serial application. please refer to the next section of this document for alternative configura tion options. the ulcd - 32 - ptu has a comprehensive range of serial commands ready to be received from the r aspberry pi , to draw primitives such as lines, rectangles, circles and text, to displaying images, playing sound and logging data to usd card. communication to the display module is performed via the raspberry pis serial port (rx and tx) . power for the display is supplied from the raspberry pis 5v bus. no external power is required for the display module as all power is supplied from the raspberry pi , via the adaptor. for a detailed listing of the serial commands available, please refer to the appendix section of this document. 4d serial pi adaptor the ulcd - 32 - ptu display module raspberry pi display module pack connected (note: raspberry pi not included)
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 4 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack 2. advanced hardware options the display module ( ulcd - 32 - ptu) is a very capable and powerful piece of hardware, which can be reconfigured beyond the boundaries of the serial e nvironment , which is what is loaded on the module when shipped . with the use of the 4d systems workshop4 ide software, the display module can be configured and programmed, which enables the user to utilise the display module in more ways than what is possible when using it in the serial configuration. if a user wishes to investigate the capabilities of the ulcd - 32 - ptu and reconfigure the display mo dule, please refer to the datasheet for the ulcd - 32 - ptu , available from the 4d systems website, www.4dsystems.com.au . the user can freely change back to the configuration the module was shipped in if desired, all via the workshop4 ide software. to take advantage of the 4d systems workshop 4 software, a 4d programming cable is required, which can be purchased from the 4d systems website, or from a 4d systems distributor. depending on what the user requires, a micro - sd card may also be required. please refer to the datasheet for the ulcd - 32 - ptu for more information, along with information on the starter kits which is also available, which includes both the programming cable and a micro - sd card. if the ulcd - 32 - ptu display module is programmed to be used with the vi si - genie en vironment , 4d systems has created a library for the raspberry pi specific for the visi - genie environment . please refer to the ulcd - 32 - ptu - pi product page on the website fo r more information, along with the link for the 4d systems github rep ository wh ere this library is locat ed for download. if the ulcd - 32 - ptu display module is programmed to be used with the serial environment, 4d systems have created a c library which is included with workshop 4, but also a vailable to be do wnloaded from the 4d sy stems gi th ub reposit ory. this library is a generic c library, so not specific to the raspberry pi, however can easily be ported as all source code is included in the rep osit ory. an alternative is to not use the library at all, and u tilise the raw commands which can be sent from an y host controller . please refer to the w orkshop 4 product page, and d ow nload the serial command set documen t for more information.
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 5 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack 3. c library functions the following is a list of the library functions available to use with the 4d systems c serial library. for detailed information on each of these functions, please refer to the p icaso serial command set reference manual document, available from the workshop 4 p roduct p age on the 4d systems website, www.4dsystems.com.au graphics functions: ? gfx_cls() ? gfx_changecolour(oldcolour, newcolour) ? gfx_circle(x, y, radius, colour) ? gfx_circlefilled(x, y, radius, colour) ? gfx_line(x1, y1, x2, y2, colour) ? gfx_rectangle(x1, y1, x2, y2, colour) ? gfx_rectanglefilled(x1, y1, x2, y2, colour) ? gfx_polyline(n, vx, vy, colour) ? gfx_polygon(n, vx, vy, col our) ? gfx_triangle(x1, y1, x2, y2, x3, y3, colour) ? gfx_orbit(angle, distance) ? gfx_putpixel(x, y, colour) ? gfx_getpixel(x, y) ? gfx_moveto(xpos, ypos) ? gfx_lineto(xpos, ypos) ? gfx_setclipregion() ? gfx_ellipse(x, y, xrad, yrad, colour) ? gfx_ellipsefilled(x, y, xrad , yrad, colour) ? gfx_button(state, x, y, buttoncolour, textcolour, font, textwidth, textheight, text) ? gfx_panel(state, x, y, width, height, colour) ? gfx_slider(mode, x1, y1, x2, y2, colour, scale, value) ? gfx_screencopypaste(xs, ys, xd, yd, width, height) ? gfx _trianglefilled(x1, y1, x2, y2, x3, y3, colr) ? gfx_polygonfilled(n, vx, vy, colr) ? gfx_get(mode) ? gfx_clipwindow(x1, y1, x2, y2) ? gfx_set(function, value) gfx_set shortcuts: ? gfx_bgcolour(colour) ? gfx_clipping(mode) ? gfx_transparentcolour(colour) ? gfx_transparency(mode) ? gfx_framedelay(delay) ? gfx_screenmode(delay) ? gfx_outlinecolour(colour) ? gfx_contrast(value) ? gfx_linepattern(pattern) ? gfx_bevelwidth(mode) ? gfx_bevelshadow(value) touch screen functions: ? touch_detectregion(x1, y1, x2, y2) ? touch_set (mode) ? touch_get(mode)
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 6 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack text and string functions: ? charwidth('char') ? charheight('char') ? putstr(pointer) ? txt_set(function, value) txt_set shortcuts: ? txt_fgcolour(colour) ? txt_bgcolour(colour) ? txt_fontid(id) ? txt_width(multiplier) ? txt_height(multiplier) ? txt_xgap(pixelcount) ? txt_ygap(pixelcount) ? txt_opacity(mode) ? txt_bold(mode) ? txt_italic(mode) ? txt_inverse(mode) ? txt_underlined(mode) ? txt_attributes(value) ? txt_wrap(value) image control functions: ? img_setposition(handle, index, xpos, ypos) ? img_enable(handle, index) ? img_disable(handle, index) ? img_darken(handle, index) ? img_lighten(handle, index) ? img_setword(handle, index, offset, word) ? img_getword(handle, index, offset) ? img_show(handle, index) ? img_setattributes(handle, index, value) ? img_clearattributes(handle, index, value) ? img_touched(handle, index) media functions (sd/sdhc memory card): ? media_init() ? media_setadd(hiword, loword) ? media_setsector(hiword, loword) ? media_rdsector(destination_address) ? media_wrsector(source_address) ? media_readbyte() ? media_readword() ? media_writebyte(byte_val) ? media_writeword(word_val) ? media_flush() ? media_image(x, y) ? media_video(x, y) ? media_videoframe(x, y, framenumber) serial (uart) communications functions: ? setbaud(rate)
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 7 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack fat16 file functions: ? file_error() ? file_count(filename) ? file_dir(filename) ? file_findfirst(fname) ? file_findnext() ? file_exists(fname) ? file_open(fname, mode) ? file_close(handle) ? file_read(destination, size, handle) ? file_seek(handle, hiword, loword) ? file_index(handle, hisize, losize, recordnum) ? file_tell(handle, &hi word, &loword) ? file_write(source, size, handle) ? file_size(handle, &hiword, &loword) ? file_image(x, y, handle) ? file_screencapture(x, y, width, height, handle) ? file_putc(char, handle) ? file_getc(handle) ? file_putw(word, handle) ? file_getw(handle) ? file_puts (source, handle) ? file_gets(*string, size, handle) ? file_erase(fname) ? file_rewind(handle) ? file_loadfunction(fname.4xe) ? file_run(fname..4xe, arglistptr) ? file_exec(fname..4xe, arglistptr) ? file_loadimagecontrol(fname1, fname2, mode) ? file_mount() ? file_unmount() ? file_playwav sound control functions: ? snd_volume(var) ? snd_pitch(pitch) ? snd_bufsize(var) ? snd_stop() ? snd_pause() ? snd_continue() ? snd_playing() timer functions: ? sys_sleep(units)
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 8 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack 4. specifications and ratings recommended operating conditions parameter conditions min typ max units supply voltage (vcc) 4.5 -- 5.5 v operating temperature - 10 -- +70 c ordering information order code: ulcd - 32 - ptu - pi package: 138mm x 100mm x 30mm packaging: module sealed in antistatic foam padded 4d systems box
4d systems ulcd - 32 - ptu - pi ? 2012 4d systems page 9 of 9 www.4dsystems.com.au ulcd - 32 - ptu - pi C raspberry pi display module pack 5. legal notice proprietary information the information contained in this document is the property of 4d systems pty. ltd. and may be the subject of patents pending or granted, and must not be copied or disclosed without prior written permission. 4d systems endeavours to ensure that the information in this document is correct and fairly stated but does not accept liability for any error or omission. the development of 4d systems products and services is continuous and published information may not be up to d ate. it is important to check the current position with 4d systems. 4d systems reserves the right to modify, update or makes changes to specifications or written material without prior notice at any time. all trademarks belong to their respective owners an d are recognised and acknowledged. disclaimer of warranties & limitation of liability 4d systems makes no warranty, either expressed or implied with respect to any product, and specifically disclaims all other warranties, including, without limitation, warranties for merchantability, non - infringement and fitness for any particular purpose. information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates. it is your responsibility to ensure that your application meets with your specifications. images and graphics used throughout this document are for illustrative purposes only. all images and graphics used are possible to be displayed on the 4d systems range of produ cts, however the quality may vary. in no event shall 4d systems be liable to the buyer or to any third party for any indirect, incidental, special, consequential, punitive or exemplary damages (including without limitation lost profits, lost savings, or lo ss of business opportunity) arising out of or relating to any product or service provided or to be provided by 4d systems, or the use or inability to use the same, even if 4d systems has been advised of the possibility of such damages. 4d systems products are not fault tolerant nor designed, manufactured or intended for use or resale as on line control equipment in hazardous environments requiring fail C safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication s ystems, air traffic control, direct life support machines or weapons systems in which the failure of the product could lead directly to death, personal injury or severe physical or environmental damage (high risk activities). 4d systems and its suppl iers specifically disclaim any expressed or implied warranty of fitness for high risk activities. use of 4d systems products and devices in 'high risk activities' and in any other application is entirely at the buyers risk, and the buyer agrees to defend , indemnify and hold harmless 4d systems from any and all damages, claims, suits, or expenses resulting from such use. no licenses are conveyed, implicitly or otherwise, under any 4d systems intellectual property rights. 6. contact information for technic al support: support@4dsystems.com.au for sales support: sales@4dsystems.com.au website: www.4dsystems.com.au copyright 4d systems pty. ltd. 2000 - 2012.
mouser electronics authorized distributor click to view pricing, inventory, delivery & lifecycle information: 4d systems: ? ulcd-32ptu-pi
|
